home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / share / groff / 1.19.1 / tmac / www.tmac < prev    next >
Encoding:
Text File  |  2005-10-13  |  24.3 KB  |  931 lines
  1. .ig
  2. www.tmac - macro package for adding HTML elements to roff documents.
  3.  
  4. File position: <groff_source_top>/tmac/www.tmac
  5. Installed position: groff's main macro directory.
  6.  
  7. ------------------------------------------------------------------------
  8.     Legalize
  9. ------------------------------------------------------------------------
  10.  
  11. This file is part of groff, the GNU roff type-setting system.
  12.  
  13. Copyright (C) 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
  14. written by Gaius Mulley <gaius@glam.ac.uk>, with additions by
  15. Werner Lemberg <wl@gnu.org> and Bernd Warken <bwarken@mayn.de>.
  16.  
  17. groff is free software; you can redistribute it and/or modify it under
  18. the terms of the GNU General Public License as published by the Free
  19. Software Foundation; either version 2, or (at your option) any later
  20. version.
  21.  
  22. groff is distributed in the hope that it will be useful, but WITHOUT
  23. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  24. FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  25. for more details.
  26.  
  27. You should have received a copy of the GNU General Public License
  28. along with groff; see the file COPYING.  If not, write to the Free
  29. Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  30. 02111-1307, USA.
  31.  
  32.  
  33. ------------------------------------------------------------------------
  34.     Description
  35. ------------------------------------------------------------------------
  36.  
  37. A simple set of macros to provide HTML documents with basic
  38. www functionality.  It should work with any macro set.
  39. ..
  40. .
  41. .\" --------------------------------------------------------------------
  42. .\" Setup
  43. .\" --------------------------------------------------------------------
  44. .
  45. .nr _C \n(.C
  46. .cp 0
  47. .
  48. .nr www-html 0
  49. .if '\*[.T]'html' .nr www-html 1
  50. .
  51. .\" set up www-image-template
  52. .
  53. .if !d www-image-template \
  54. .  ds www-image-template
  55. .
  56. .if r ps4html \{\
  57. .  \" remove the title command when we are generating images for html
  58. .  \" (stops a title accidentally appearing inside an image)
  59. .  di www-notitle
  60. .  tl ''''
  61. .  di
  62. .  rm tl
  63. .  de tl
  64. .  .
  65. .\}
  66. .
  67. .
  68. .\" --------------------------------------------------------------------
  69. .\" Test for `.substring'; result in register `www.substring_ok'.
  70. .\" The automated break points in .URL addresses are only added if
  71. .\" this register is non-zero.
  72. .\"
  73. .nr www:substring_ok 0
  74. .de www:@test_substring
  75. .  if !d substring \
  76. .    return
  77. .  ds \\$0:s abcdefg\"
  78. .  substring \\$0:s 1 1
  79. .  if !'\\*[\\$0:s]'b' \{\
  80. .    rm \\$0:s
  81. .    return
  82. .  \}
  83. .  ds \\$0:s abcdefg\"
  84. .  substring \\$0:s 0 0
  85. .  if !'\\*[\\$0:s]'a' \{\
  86. .    rm \\$0:s
  87. .    return
  88. .  \}
  89. .  ds \\$0:s abcdefg\"
  90. .  substring \\$0:s 1 -1
  91. .  if !'\\*[\\$0:s]'bcdefg' \{\
  92. .    rm \\$0:s
  93. .    return
  94. .  \}
  95. .  nr www:substring_ok 1
  96. .  rm \\$0:s
  97. ..
  98. .www:@test_substring
  99. .rm www:@test_substring
  100. .
  101. .
  102. .\" --------------------------------------------------------------------
  103. .\" Local Macros
  104. .\" --------------------------------------------------------------------
  105. .
  106. .\" --------------------------------------------------------------------
  107. .\" www:error (<test>...)
  108. .\"
  109. .\" Print error message
  110. .\"
  111. .de www-error
  112. .  tm \\n[.F]:\\n[.c]: macro error: \\$*
  113. ..
  114. .als www:error www-error
  115. .
  116. .\" --------------------------------------------------------------------
  117. .\" www:lenstr (<register_name> <string_name>)
  118. .\"
  119. .\" Store length of string named <string_name> into register named
  120. .\" <register_name>.
  121. .\"
  122. .de www:lenstr
  123. .  if !(\\n[.$] == 2) \{\
  124. .    tm .\\$0 expects 2 arguments.
  125. .    ab
  126. .  \}
  127. .  length \\$0:n x\\*[\\$2]
  128. .  nr \\$1 (\\n[\\$0:n]-1)
  129. .  rr \\$0:n
  130. ..
  131. .\" --------------------------------------------------------------------
  132. .\" www:splitstr (<name>)
  133. .\"
  134. .\" Add a space character between any two adjacent characters in string
  135. .\" <name> and restore result into the string variable <name>; space
  136. .\" characters are first replaced by the word `space'.
  137. .\"
  138. .de www:splitstr
  139. .  if !(\\n[.$] == 1) \
  140. .    www:error .\\$0 expects 1 argument.
  141. .  if '\\*[\\$1]'' \
  142. .    return
  143. .  ds \\$0:r "\\*[\\$1]\""
  144. .  ds \\$0:s\"
  145. .  while 1 \{\
  146. .    ds \\$0:c "\\*[\\$0:r]\""
  147. .    substring \\$0:c 0 0\"
  148. .    ie '\\*[\\$0:c]' ' \
  149. .      as \\$0:s " space\""
  150. .    el \
  151. .      as \\$0:s " \\*[\\$0:c]\""
  152. .    www:lenstr \\$0:n \\$0:r
  153. .    if (\\n[\\$0:n] <= 1) \{\
  154. .      break
  155. .    \}
  156. .    substring \\$0:r 1 -1\"
  157. .  \}
  158. .  if !'\\*[\\$0:s]'' \
  159. .    substring \\$0:s 1 -1 
  160. .  ds \\$1 \\*[\\$0:s]
  161. .  rm \\$0:c
  162. .  rr \\$0:n
  163. .  rm \\$0:r
  164. .  rm \\$0:s
  165. ..
  166. .\" --------------------------------------------------------------------
  167. .\" www:url_breaks (<string_name>)
  168. .\"
  169. .\" Add `\:' (possible break point) within URL strings after `/'.
  170. .\"
  171. .\" Smart about multiple `/', existing `\:', and space characters;
  172. .\" does not set a break point if less than 5 characters would go to
  173. .\" the next line.
  174. .\"
  175. .de www:url_breaks
  176. .  if !(\\n[.$] == 1) \
  177. .    www:error .\\$0 expects 1 argument.
  178. .  if !\n[www:substring_ok] \
  179. .    return
  180. .  ds \\$0:s "\\*[\\$1]\""
  181. .  www:splitstr \\$0:s
  182. .  www:url_breaks_splitted \\$0:s \\*[\\$0:s]
  183. .  ds \\$1 "\\*[\\$0:s]\""
  184. .  rm \\$0:s
  185. ..
  186. .\" --------------------------------------------------------------------
  187. .\" www:url_breaks_splitted (<result> <char> [<char>...])
  188. .\"
  189. .\" Add `\:' within URL strings, but arguments are a splitted string.
  190. .\"
  191. .\" Arguments: >=2: <result> <char> [<char>...]
  192. .\"
  193. .de www:url_breaks_splitted
  194. .  nr \\$0:min 5             \" minimal number of characters for next line
  195. .  if (\\n[.$] < 2) \
  196. .    www:error .\\$0 expects at least 2 arguments.
  197. .  ds \\$0:res \\$1\"
  198. .  shift
  199. .  ds \\$0:s\"
  200. .  nr \\$0:done 0
  201. .  while !\\n[\\$0:done] \{\
  202. .    if (\\n[.$] <= 0) \{\
  203. .      nr \\$0:done 1
  204. .      break
  205. .    \}
  206. .    if '\\$1'space' \{\
  207. .      as \\$0:s " \""
  208. .      shift
  209. .      continue
  210. .    \}
  211. .    if (\\n[.$] < \\n[\\$0:min]) \{\
  212. .      as \\$0:s "\\$1\""
  213. .      shift
  214. .      continue
  215. .    \}
  216. .    if !'\\$1'/' \{\
  217. .      as \\$0:s "\\$1\""
  218. .      shift
  219. .      continue
  220. .    \}
  221. .    \" we are at a `/' character
  222. .    while '\\$1'/' \{\
  223. .      as \\$0:s /\"
  224. .      if (\\n[.$] == 0) \{\
  225. .        nr \\$0:done 1
  226. .        break
  227. .      \}
  228. .      shift
  229. .    \}
  230. .    if \\n[\\$0:done] \
  231. .      break
  232. .    if (\\n[.$] < \\n[\\$0:min]) \
  233. .      continue
  234. .    if '\\$1'\:' \
  235. .      shift
  236. .    as \\$0:s \:\"
  237. .  \}
  238. .  ds \\*[\\$0:res] \\*[\\$0:s]\"
  239. .  rm \\$0:res
  240. .  rm \\$0:s
  241. ..
  242. .\" --------------------------------------------------------------------
  243. .\" User Interface
  244. .\" --------------------------------------------------------------------
  245. .
  246. .\" --------------------------------------------------------------------
  247. .\" HTML (<address> <description> [<punctuation>])
  248. .\"
  249. .\" the main auxiliary macro for the HTML interface
  250. .\"
  251. .de HTML
  252. .  if \\n[www-html] \{\
  253. .    \" the following line makes the vertical mode leave, so to say
  254. .    nop \&
  255. .    nop \X^html:\\$*^
  256. .  \}
  257. ..
  258. .\"
  259. .\" an auxiliary macro for HTML (without following space)
  260. .\"
  261. .de HTML-NS
  262. .  if \\n[www-html] \
  263. .    nop \X^html:\\$*^\c
  264. ..
  265. .\" --------------------------------------------------------------------
  266. .\" HX n
  267. .\"
  268. .\"   Automatic heading level cut off.
  269. .\"
  270. .\"   N is the depth limit of automatically linked headings.  So a depth
  271. .\"   of 2 would cause grohtml to generate a list of links for `.NH 1'
  272. .\"   and `.NH 2' but not for `.NH 3'.
  273. .\"
  274. .de HX
  275. .  if \\n[www-html] \
  276. .    nop \X^index:\\$*^
  277. ..
  278. .\" --------------------------------------------------------------------
  279. .\" BCL foreground background active not-visited visited
  280. .\"
  281. .de BCL
  282. .  HTML <body text=\\$1 bgcolor=\\$2 link=\\$3 alink=\\$4 vlink=\\$5>
  283. ..
  284. .\" --------------------------------------------------------------------
  285. .\" BGIMG imagefile
  286. .\"
  287. .de BGIMG
  288. .  HTML <body background=\\$1>
  289. ..
  290. .\" --------------------------------------------------------------------
  291. .\" URL url [description] [after]
  292. .\"     if description is absent then the url becomes the anchor text
  293. .\"
  294. .de URL
  295. .  ds \\$0:adr \\$1\"
  296. .  www:url_breaks \\$0:adr
  297. .  ie \\n[www-html] \{\
  298. .    ie '\\$2'' \
  299. .       HTML <a href="\\$1">\\$1</a>\\$3
  300. .    el \
  301. .       HTML <a href="\\$1">\\$2</a>\\$3
  302. .  \}
  303. .  el \{\
  304. .    if !r ps4html .ad l
  305. .    ie '\\$2'' \
  306. .       nop \%\[la]\m[blue]\f[C]\\*[\\$0:adr]\f[]\m[]\[ra]\\$3
  307. .    el \
  308. .       nop \m[blue]\\$2\m[] \%\[la]\f[C]\\*[\\$0:adr]\f[]\[ra]\\$3
  309. .    if !r ps4html .ad
  310. .  \}
  311. .  rm \\$0:adr
  312. ..
  313. .\" --------------------------------------------------------------------
  314. .\" FTP url description [after]
  315. .\"
  316. .\"   Same as URL.
  317. .\"
  318. .als FTP URL
  319. .\" --------------------------------------------------------------------
  320. .\" MTO address description [after]
  321. .\"
  322. .\"   ADDRESS is the email address (without the `mailto:' prefix).
  323. .\"
  324. .\"   DESCRIPTION is the optional name.  If an empty argument is given,
  325. .\"   ADDRESS is used instead.
  326. .\"
  327. .\"   AFTER is optional stuff printed immediately after ADDRESS
  328. .\"   (resp. DESCRIPTION).
  329. .\"
  330. .\"     Example:
  331. .\"
  332. .\"       Foobar has been written by
  333. .\"       .MTO fred@foo.bar "Fredrick Bloggs" .
  334. .\"
  335. .de MTO
  336. .  ie \\n[www-html] \{\
  337. .    ie '\\$2'' \
  338. .      URL mailto:\\$1 \\$1 "\\$3"
  339. .    el \
  340. .      URL mailto:\\$1 "\\$2" "\\$3"
  341. .  \}
  342. .  el \{\
  343. .    ie '\\$2'' \
  344. .      nop \%\m[blue]\f[C]\\$1\f[]\m[]\\$3
  345. .    el \
  346. .      nop \m[blue]\\$2\m[] \%\[la]\f[C]\\$1\f[]\[ra]\\$3
  347. .  \}
  348. ..
  349. .\" --------------------------------------------------------------------
  350. .\" TAG name
  351. .\"
  352. .\"   Generate an html name NAME.
  353. .\"
  354. .de TAG
  355. .  HTML <a name="\\$1"></a>
  356. ..
  357. .\" --------------------------------------------------------------------
  358. .\" IMG [-R|-L|-C] filename [width] [height]
  359. .\"
  360. .\"   Include an image of any type (will only work for -Thtml).
  361. .\"
  362. .\"   Alignment is centered by default (-C).
  363. .\"   Default value for WIDTH is 1i.
  364. .\"   If HEIGHT is not given, WIDTH is used as the height.
  365. .\"
  366. .de IMG
  367. .  ie \\n[www-html] \{\
  368. .    ie '\\$2'-R' \
  369. .      HTML-TAG ".right-image"
  370. .    el \{\
  371. .      ie '\\$2'-L' \
  372. .        HTML-TAG ".left-image"
  373. .      el \
  374. .        HTML-TAG ".centered-image"
  375. .    \}
  376. .    nr www-width 100
  377. .    if !'\\$3'' \
  378. .      nr www-width \\$3
  379. .    nr www-height \\n[www-width]
  380. .    if !'\\$4'' \
  381. .      nr www-height \\$4
  382. .    HTML <img src="\\$1" width=\\n[www-width] height=\\n[www-height]>
  383. .  \}
  384. .  el \
  385. .    nop \[la]\f[C]\\$1\f[]\[ra]
  386. ..
  387. .\" --------------------------------------------------------------------
  388. .\" HTML-TAG
  389. .\"
  390. .\"   Emit a tag for grohtml.  This is an internal macro.
  391. .\"
  392. .de HTML-TAG
  393. .  if \\n[www-html] \{\
  394. .    \" the following line makes the vertical mode leave, so to say
  395. .    nop \&
  396. .    nop \X^html-tag:\\$*^
  397. .  \}
  398. ..
  399. .\" --------------------------------------------------------------------
  400. .\" HTML-TAG-NS
  401. .\"
  402. .\"   Emit a tag for grohtml (without a space).  This is an internal macro.
  403. .\"
  404. .de HTML-TAG-NS
  405. .  if \\n[www-html] \
  406. .    nop \X^html-tag:\\$*^\c
  407. ..
  408. .\" --------------------------------------------------------------------
  409. .\" PIMG  [-R|-L|-C] filename [width] [height]
  410. .\"
  411. .\"   Include a png image.  It will work for -Tps and -Thtml.
  412. .\"   The default value for WIDTH and HEIGHT is zero; the default
  413. .\"   alignment is centering (-C).
  414. .\"
  415. .\" Note: This macro can only be used with the `-U' option of groff,
  416. .\"       activating unsafe mode, if not used with -Thtml; the PNG image
  417. .\"       is then converted to the EPS format using netpbm utilities.
  418. .\"
  419. .de PIMG
  420. .  ie \\n[www-html] \{\
  421. .    ie '\\$1'-R' \
  422. .      HTML-TAG ".right-image"
  423. .    el \{\
  424. .      ie '\\$1'-L' \
  425. .        HTML-TAG ".left-image"
  426. .      el \
  427. .        HTML-TAG ".centered-image"
  428. .    \}
  429. .    nr www-width 0
  430. .    nr www-height 0
  431. .    if !'\\$3'' \
  432. .      nr www-width (\\$3 * 100 / 240)
  433. .    if !'\\$4'' \
  434. .      nr www-height (\\$4 * 100 / 240)
  435. .    ie (\\n[www-width] == 0) \{\
  436. .      ie (\\n[www-height] == 0) \
  437. .        HTML <img src="\\$2">
  438. .      el \
  439. .        HTML <img src="\\$1" height=\\n[www-height]>
  440. .    \}
  441. .    el \{\
  442. .      ie (\\n[www-height] == 0) \
  443. .        HTML <img src="\\$2" width=\\n[www-width]>
  444. .      el \
  445. .        HTML <img src="\\$2" width=\\n[www-width] height=\\n[www-height]>
  446. .    \}
  447. .  \}
  448. .  el \{\
  449. .    if !r ps4html \{\
  450. .      www-make-unique-name
  451. .      sy pngtopnm \\$2 | pnmcrop -white | pnmtops -noturn > \\*[www-unique-name].eps
  452. .      ie '\\$1'-C' \
  453. .        PSPIC \\*[www-unique-name].eps \\$3 \\$4
  454. .      el \
  455. .        PSPIC \\$1 \\*[www-unique-name].eps \\$3 \\$4
  456. .    \}
  457. .  \}
  458. ..
  459. .
  460. .\" --------------------------------------------------------------------
  461. .\" auxiliary definitions for MPIMG
  462. .\"
  463. .nr www-left-ll-trap 0
  464. .nr www-left-po-trap 0
  465. .nr www-right-ll-trap 0
  466. .
  467. .de www-finish-left-po
  468. .  po -(\\n[www-left-indent]u + \\n[www-image-gap]u)
  469. .  wh \\n[www-left-po-trap]u
  470. .  nr www-left-indent 0
  471. ..
  472. .
  473. .\" called when the -R picture is finished
  474. .de www-finish-right-ll
  475. .  ll +(\\n[www-right-indent]u + \\n[www-image-gap]u)
  476. .  \" now see whether we need to inline www-finish-left-ll
  477. .  if (\\n[www-left-ll-trap]u > 0) \
  478. .    if ((\\n[www-right-ll-trap]u + 1v) >= \\n[www-left-ll-trap]u) \{\
  479. .      mk www-left-po-trap
  480. .      nr www-left-po-trap +1v
  481. .      wh \\n[www-left-po-trap]u www-finish-left-po
  482. .      ll +\\n[www-left-indent]u
  483. .      wh \\n[www-left-ll-trap]u
  484. .      nr www-left-ll-trap 0
  485. .    \}
  486. .  \" and see whether we need to inline www-finish-left-po
  487. .  if (\\n[www-left-po-trap]u > 0) \
  488. .    if ((\\n[www-right-ll-trap]u + 1v) >= \\n[www-left-po-trap]u) \{\
  489. .      po -\\n[www-left-indent]u
  490. .      wh \\n[www-left-po-trap]u
  491. .      nr www-left-indent 0
  492. .    \}
  493. .  wh \\n[www-right-ll-trap]u
  494. .  nr www-right-ll-trap 0
  495. ..
  496. .
  497. .de www-finish-left-ll
  498. .  if (\\n[www-right-ll-trap] > 0) \
  499. .    if ((\\n[www-left-ll-trap] + 1v) >= \\n[www-right-ll-trap]) \{\
  500. .      ll +\\n[www-right-indent]u
  501. .      nr www-right-ll-trap 0
  502. .    \}
  503. .  mk www-left-po-trap
  504. .  nr www-left-po-trap +1v
  505. .  wh \\n[www-left-po-trap]u www-finish-left-po
  506. .  ll +(\\n[www-left-indent]u + \\n[www-image-gap]u)
  507. .  wh \\n[www-left-ll-trap]u
  508. .  nr www-left-ll-trap 0
  509. ..
  510. .\" --------------------------------------------------------------------
  511. .\" MPIMG [-R|-L] [-G gap] filename [width [height]]
  512. .\"
  513. .\"   Include a png image and wrap text around it.  It will work for
  514. .\"   -Tps and -Thtml.  The default value for WIDTH is 1i; default value
  515. .\"   for HEIGHT is WIDTH; the default alignment is left (-L).
  516. .\"   -G is used to insert a gap between the text and the image.
  517. .\"
  518. .\" Note: This macro can only be used with the `-U' option of groff,
  519. .\"       activating unsafe mode, if not used with -Thtml; the PNG image
  520. .\"       is then converted to the EPS format using netpbm utilities.
  521. .\"
  522. .
  523. .nr www-htmlimage-gap 0
  524. .
  525. .de MPIMG
  526. .  nr www-image-just 1
  527. .  nr www-image-gap 0
  528. .  while (\\n[.$] > 0) \{\
  529. .    if '-L'\\$1' \{\
  530. .      nr www-image-just 1
  531. .      shift
  532. .      continue
  533. .    \}
  534. .    if '-R'\\$1' \{\
  535. .      nr www-image-just 0
  536. .      shift
  537. .      continue
  538. .    \}
  539. .    if '-G'\\$1' \{\
  540. .      nr www-image-gap \\$2
  541. .      nr www-htmlimage-gap (\\$2 * 100 / 240)
  542. .      shift 2
  543. .      continue
  544. .    \}
  545. .    break
  546. .  \}
  547. .  nr www-width 1i
  548. .  if !'\\$2'' \
  549. .    nr www-width \\$2
  550. .  nr www-height \\n[www-width]
  551. .  if !'\\$3'' \
  552. .    nr www-height \\$3
  553. .  nr www-width (\\n[www-width] * 100 / 240)
  554. .  nr www-height (\\n[www-height] * 100 / 240)
  555. .
  556. .  ie \\n[www-html] \{\
  557. .    ie !\\n[www-image-just] \
  558. .      HTML <img src="\\$1" hspace=\\n[www-htmlimage-gap] \
  559.              align=right width=\\n[www-width] height=\\n[www-height]>
  560. .    el \
  561. .      HTML <img src="\\$1" hspace=\\n[www-htmlimage-gap] \
  562.              align=left width=\\n[www-width] height=\\n[www-height]>
  563. .  \}
  564. .  el \{\
  565. .    if !r ps4html \{\
  566. .      www-make-unique-name
  567. .      sy pngtopnm \\$1 | pnmcrop -white | pnmtops -noturn > \\*[www-unique-name].eps
  568. .      ie !\\n[www-image-just] \{\
  569. .        \" we must now disable a possible left image trap
  570. .        sp -1
  571. .        if (\\n[www-left-ll-trap] > 0) \
  572. .          wh \\n[www-left-ll-trap]u
  573. .        if (\\n[www-left-po-trap] > 0) \
  574. .          wh \\n[www-left-po-trap]u
  575. .        PSPIC -R \\*[www-unique-name].eps \\$2 \\$3
  576. .        sp -\\n[ps-desht]u
  577. .        nr www-right-indent \\n[ps-deswid]u
  578. .        \" we want to have some space between text and image,
  579. .        \" so the line length must be shorter
  580. .        ll -(\\n[www-right-indent]u + \\n[www-image-gap]u)
  581. .        mk www-right-ll-trap
  582. .        nr www-right-ll-trap +(\\n[ps-desht]u - 1v)
  583. .        wh \\n[www-right-ll-trap]u www-finish-right-ll
  584. .        \" now restore possible left trap
  585. .        if (\\n[www-left-ll-trap] > 0) \
  586. .          wh \\n[www-left-ll-trap]u www-finish-left-ll
  587. .        if (\\n[www-left-po-trap] > 0) \
  588. .          wh \\n[www-left-po-trap]u
  589. .      \}
  590. .      el \{\
  591. .        \" we must now disable a possible right image trap
  592. .        if (\\n[www-right-ll-trap] > 0) \
  593. .          wh \\n[www-right-ll-trap]u
  594. .        PSPIC -L \\*[www-unique-name].eps \\$2 \\$3
  595. .        sp -\\n[ps-desht]u
  596. .        nr www-left-indent \\n[ps-deswid]u
  597. .        \" increase offset by gap
  598. .        po +(\\n[www-left-indent]u + \\n[www-image-gap]u)
  599. .        \" decrease line length by gap
  600. .        ll -(\\n[www-left-indent]u + \\n[www-image-gap]u)
  601. .        mk www-left-ll-trap
  602. .        nr www-left-ll-trap +(\\n[ps-desht]u - 1v)
  603. .        wh \\n[www-left-ll-trap]u www-finish-left-ll
  604. .        \" now restore possible right trap
  605. .        if (\\n[www-right-ll-trap] > 0) \
  606. .          wh \\n[www-right-ll-trap]u www-finish-right-ll
  607. .      \}
  608. .    \}
  609. .  \}
  610. ..
  611. .\" --------------------------------------------------------------------
  612. .\" HnS n
  613. .\"
  614. .\"   Begin heading.  Heading level is N.
  615. .\"
  616. .\" HnE
  617. .\"
  618. .\"   End heading.
  619. .\"
  620. .\" If your heading contains URL, FTP, MTO macros you might wish to
  621. .\" disable automatic links to headings.  This can be done via `-P-l'
  622. .\" from the command line or by using a cakk to `.HX 0'.
  623. .\"
  624. .nr www-heading-no -1
  625. .
  626. .de HnS
  627. .  ie '\\$1'' \
  628. .    nr www-heading-no 1
  629. .  el \
  630. .    nr www-heading-no \\$1
  631. .  HTML-TAG ".NH \\n[www-heading-no]"
  632. ..
  633. .
  634. .de HnE
  635. .  if (\\n[www-heading-no] == -1) \
  636. .    www-error "HnE found without a corresponding HnS"
  637. .  br
  638. ..
  639. .\" --------------------------------------------------------------------
  640. .\" LK
  641. .\"
  642. .\"   Emit the automatically collected links derived from
  643. .\"   section/numbered headings at this position.
  644. .\"
  645. .de LK
  646. .  HTML-TAG ".links"
  647. ..
  648. .\" --------------------------------------------------------------------
  649. .\" HR
  650. .\"
  651. .\"   Produce a horizontal line
  652. .\"
  653. .de HR
  654. .  ie \\n[www-html] \{\
  655. .    ti 0
  656. .    HTML-NS <hr>
  657. .  \}
  658. .  el \
  659. .    sp
  660. ..
  661. .\" --------------------------------------------------------------------
  662. .\" NHR
  663. .\"
  664. .\"  Suppresses the generation of the top and bottom rules which grohtml
  665. .\"  emits by default.
  666. .\"
  667. .de NHR
  668. .  HTML-TAG ".no-auto-rule"
  669. ..
  670. .\"
  671. .\" www-end-nowhere - end of input trap called to finish diversion.
  672. .\"
  673. .de www-end-nowhere
  674. .  di
  675. ..
  676. .\" --------------------------------------------------------------------
  677. .\" HTL
  678. .\"
  679. .\"   Generate an HTML title only.  This differs from the -ms .TL macro
  680. .\"   which generates both an HTML title and a H1 heading.
  681. .\"
  682. .\"   This is useful when an author wishes to use a HTML title as search
  683. .\"   engine fodder but a graphic title in the document.
  684. .\"
  685. .\"   The macro terminates when a space or break is seen (.sp, .br).
  686. .\"
  687. .de HTL
  688. .  HTML-TAG ".html-tl"
  689. .  if !\\n[www-html] \{\
  690. .    di www-nowhere
  691. .    it 2 www-end-nowhere
  692. .  \}
  693. ..
  694. .
  695. .\" --------------------------------------------------------------------
  696. .\" auxiliary definitions for ULS / ULE
  697. .\"
  698. .ds www-level1 \[bu]\ \ \"
  699. .ds www-level2 \[sq]\ \ \"
  700. .ds www-level3 \[ci]\ \ \"
  701. .nr www-level 0
  702. .nr www-depth 0
  703. .
  704. .\"
  705. .\" Auxiliary macro for ULS.
  706. .\"
  707. .de www-push-level
  708. .  nr www-level +1
  709. .  if (\\n[www-level] > 3) \
  710. .    www-error "too many levels of indentation (\\n[www-level])"
  711. ..
  712. .\"
  713. .\" Auxiliary macro for ULE.
  714. .\"
  715. .de www-pop-level
  716. .  if !\\n[www-level] \
  717. .    www-error "trying to terminate a list which does not exist"
  718. .  nr www-level -1
  719. ..
  720. .\" --------------------------------------------------------------------
  721. .\" ULS
  722. .\"
  723. .\"   Start an unordered list.
  724. .\"
  725. .de ULS
  726. .  www-push-level
  727. .  ie \\n[www-html] \
  728. .    HTML "<ul>"
  729. .  el \{\
  730. .    if (\\n[www-level] == 1) \
  731. .      nr www-depth \\n[.i]
  732. .    nr www-depth +\w'\\*[www-level\\n[www-level]]'u
  733. .  \}
  734. ..
  735. .\" --------------------------------------------------------------------
  736. .\" ULE
  737. .\"
  738. .\"   End an unordered list.
  739. .\"
  740. .de ULE
  741. .  ie \\n[www-html] \
  742. .    HTML "</ul>"
  743. .  el \{\
  744. .    nr www-depth -\w'\\*[www-level\\n[www-level]]'u
  745. .    in \\n[www-depth]u
  746. .  \}
  747. .  www-pop-level
  748. ..
  749. .\" --------------------------------------------------------------------
  750. .\" LI
  751. .\"
  752. .\"   Insert a list item.
  753. .\"
  754. .de LI
  755. .  ie \\n[www-html] \
  756. .    HTML "<li>"
  757. .  el \{\
  758. .    in \\n[www-depth]u
  759. .    ti -\w'\\*[www-level\\n[www-level]]'u
  760. .    nop \\*[www-level\\n[www-level]]\c
  761. .  \}
  762. ..
  763. .\" --------------------------------------------------------------------
  764. .\" DC l text [color]
  765. .\"
  766. .\"   L is the letter to be dropped and enlarged.
  767. .\"
  768. .\"   TEXT is the following text whose height the first letter should not
  769. .\"   exceed.
  770. .\"
  771. .\"   COLOR is the optional color of the dropped letter (default black).
  772. .\"
  773. .de DC
  774. .  ds www-dropcolor black
  775. .  if !'\\$3'' \
  776. .    ds www-dropcolor \\$3
  777. .  ie '\*(.T'html' \{\
  778. .    www-make-unique-name
  779. .    MPIMG -L \\*[www-unique-name].png "(\\n[.v] * 2u)"
  780. .  \}
  781. .  el \{\
  782. .    ie r ps4html \{\
  783. .      www-make-unique-name
  784. .      \" To avoid interferences with another DC macro call which is located
  785. .      \" very near to the current one, we draw the glyph on a separate page.
  786. .      \" Otherwise it could theoretically happen that the dropped capital
  787. .      \" glyphs overlap.
  788. .      bp
  789. .      ev www-DC
  790. .      vs 80p
  791. .      nop \O[5i\\*[www-unique-name].png]\O[1]
  792. .      nop \m[\\*[www-dropcolor]]\s[40]\O[3]\\$1\O[4]
  793. .      nop \O[2]\O[0]
  794. .      br
  795. .      ev
  796. .      bp
  797. .    \}
  798. .    el \{\
  799. .      ie n \
  800. .        nop \\$1\c
  801. .      el \{\
  802. .        nr dummy \w'\\$1'u
  803. .        nr dcht ((\\n[.v] + \\n[rst]) * \\n[.ps] / \\n[rst])
  804. .        char \[dcap] \m[\\*[www-dropcolor]]\s'\\n[dcht]u'\\$1
  805. .        nop \v'\\n[.v]u'\\[dcap]\v'-\\n[.v]u'\c
  806. '        ti \w'\\[dcap]'u
  807. .      \}
  808. .    \}
  809. .  \}
  810. .  nop \\$2
  811. ..
  812. .\" --------------------------------------------------------------------
  813. .\" Setup around HTML-IMAGE and friends
  814. .\"
  815. .\" now set up TS, TE, EQ, EN default macros
  816. .\"
  817. .do if !d TS .do ds TS HTML-IMAGE
  818. .do if !d TE .do ds TE HTML-IMAGE-END
  819. .do if !d EQ .do ds EQ HTML-IMAGE
  820. .do if !d EN .do ds EN HTML-IMAGE-END
  821. .\"
  822. .\" supplementary macros used by other macro sets
  823. .\"
  824. .\" here are some tags specially for -Tps or -Thtml when invoked by
  825. .\" pre-html to generate png images from postscript.
  826. .
  827. .\" --------------------------------------------------------------------
  828. .\" HTML-DO-IMAGE - tells troff to issue an image marker which can be
  829. .\"                 read back by pre-html
  830. .\"
  831. .de HTML-DO-IMAGE
  832. .  if r ps4html \
  833. .    nop \O[5\\$2\\$1.png]\O[1]\O[3]
  834. .  if \\n[www-html] \
  835. .    nop \O[5\\$2\\$1.png]\O[0]\O[3]
  836. ..
  837. .\" --------------------------------------------------------------------
  838. .\" HTML-IMAGE-END - terminates an image for html
  839. .\"
  840. .de HTML-IMAGE-END
  841. .  if r ps4html \
  842. .    nop \O[4]\O[2]\O[0]
  843. .  if \\n[www-html] \
  844. .    nop \O[4]\O[2]\O[1]
  845. ..
  846. .
  847. .nr www-png-no 0
  848. .
  849. .\" --------------------------------------------------------------------
  850. .\" www-make-unique-name - generates another unique name in string
  851. .\"                        `www-unique-name'
  852. .\"
  853. .de www-make-unique-name
  854. .  nr www-png-no +1
  855. .  ds www-unique-name \\*[www-image-template]\\n[www-png-no]
  856. ..
  857. .\" --------------------------------------------------------------------
  858. .\" HTML-IMAGE and friends tell grohtml that this region of text needs
  859. .\"            to be rendered as an image.
  860. .\"
  861. .de HTML-IMAGE
  862. .  \" generates a centered image
  863. .  www-make-unique-name
  864. .  HTML-DO-IMAGE \\*[www-unique-name] c
  865. ..
  866. .
  867. .de HTML-IMAGE-RIGHT
  868. .  www-make-unique-name
  869. .  HTML-DO-IMAGE \\*[www-unique-name] r
  870. ..
  871. .
  872. .de HTML-IMAGE-LEFT
  873. .  www-make-unique-name
  874. .  HTML-DO-IMAGE \\*[www-unique-name] l
  875. ..
  876. .
  877. .de HTML-IMAGE-INLINE
  878. .  www-make-unique-name
  879. .  HTML-DO-IMAGE \\*[www-unique-name] i
  880. ..
  881. .
  882. .\" --------------------------------------------------------------------
  883. .\" JOBNAME
  884. .\"
  885. .\"   Generate multiple output files containing the html.
  886. .\"   A file is split whenever a .SH or .NH 1 is encountered.
  887. .\"   The argument to JOBNAME is the file stem for future output files.
  888. .\"
  889. .de JOBNAME
  890. .  HTML-TAG .job-name \\$1
  891. ..
  892. .\" --------------------------------------------------------------------
  893. .\" Final Setup
  894. .\" --------------------------------------------------------------------
  895. .
  896. .if \n[www-html] \{\
  897. .   nh
  898. .   nr HY 0
  899. .\}
  900. .
  901. .\"
  902. .\" start of some code
  903. .\"
  904. .
  905. .de CDS
  906. .ft C
  907. .nf
  908. ..
  909. .\"
  910. .\" end of some code
  911. .\"
  912. .
  913. .de CDE
  914. .fi
  915. .ft P
  916. ..
  917. .
  918. .if r ps4html .nop \O[0]
  919. .cp \n(_C
  920. .
  921. .\" now set
  922. .
  923. .\" --------------------------------------------------------------------
  924. .\" Emacs settings
  925. .\" --------------------------------------------------------------------
  926. .
  927. .\" Local Variables:
  928. .\" mode: nroff
  929. .\" End:
  930. .\" EOF
  931.